<!--
title: 工单管理
description: 
published: true
date: 2025-06-17T08:50:32.529Z
tags: 
editor: ckeditor
dateCreated: 2025-06-17T04:35:53.165Z
-->

<h1>创建工单</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  创建工单
ticket_info = sdk_creat_ticket(flow_id, name, description, data=None)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>floe_id：流程ID。值为&nbsp;string<br>name：工单标题。值为&nbsp;string<br>description：工单描述。值为&nbsp;string<br>data：流程输入参数，默认会写入到流程变量中。值为&nbsp;{}<br>&nbsp;</li>
</ul>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_creat_ticket

# 流程ID
flow_id = "570f09a2-b925-11ef-a700-0ad3783d570d"
# 工单标题
name = "测试工单"
# 工单描述
description = "测试工单"
# 输入参数
data = {
    "test": "测试输入参数"
}
# 创建工单
ticket_info = sdk_creat_ticket(flow_id, name, description, data=data)

return ticket_info</code></pre>
<p>&nbsp;</p>
<h1>强制结单</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  强制结单
res = sdk_over_ticket(ticket_id, current_node_id, data, user)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>ticket_id：工单ID。值为&nbsp;string<br>current_node_id：当前节点ID。值为&nbsp;string<br>user：操作用户。值为&nbsp;string<br>data：提交表单数据或输入参数。值为&nbsp;{}<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">{
    "code": 200,
    "data": null,
    "msg": "操作成功！"
}</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_over_ticket

# 工单ID
ticket_id = "1750146013372477"
# 当前节点
current_node_id = "Activity_0hnid40"
# 操作用户
user = current_user.id
# 输入参数
data = {
    "test": "强制结单"
}

# 强制结单
res = sdk_over_ticket(ticket_id, current_node_id, data, user)

return res</code></pre>
<p>&nbsp;</p>
<h1>提交工单</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  提交工单
res = sdk_end_ticket(ticket_id, current_node_id, data, user)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>ticket_id：工单ID。值为&nbsp;string<br>current_node_id：当前节点ID。值为&nbsp;string<br>user：提交用户。值为&nbsp;string<br>data：提交表单数据或输入参数。值为&nbsp;{}<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">{
    "code": 200,
    "data": null,
    "msg": "提交成功！"
}</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_end_ticket

# 工单ID
ticket_id = "1750146013372477"
# 当前节点
current_node_id = "Task_1piqdk6"
# 操作用户
user = current_user.id
# 输入参数
data = {
    "test": "提交测试输入参数"
}
# 提交工单
res = sdk_end_ticket(ticket_id, current_node_id, data, user)

return res</code></pre>
<p>&nbsp;</p>
<h1>重试节点</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  重试节点
res = sdk_retry_ticket(ticket_id, current_node_id, data, user, retry_type)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>ticket_id：工单ID。值为&nbsp;string<br>current_node_id：当前节点ID。值为&nbsp;string<br>user：提交用户。值为&nbsp;string<br>retry_type：重试类型。值为&nbsp;dev或produce （dev是不用发布的流程，用于流程出错后调使用）<br>data：提交表单数据或输入参数。值为&nbsp;{}<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">{
    "code": 200,
    "data": null,
    "msg": "重试成功！"
}</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_retry_ticket

# 工单ID
ticket_id = "1750146013372477"
# 当前节点
current_node_id = "Activity_0hnid40"
# 操作用户
user = current_user.id
# 输入参数
data = {
    "test": "提交测试输入参数"
}
# 重试类型
retry_type = "produce"

# 重试节点
res = sdk_retry_ticket(ticket_id, current_node_id, data, user, retry_type)

return res</code></pre>
<p>&nbsp;</p>
<h1>转派工单</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  转派工单
res = sdk_todo_user_ticket(ticket_id, current_node_id, data, user)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>ticket_id：工单ID。值为&nbsp;string<br>current_node_id：当前节点ID。值为&nbsp;string<br>user：被转派用户。值为&nbsp;string<br>data：转派数据。值为&nbsp;{"description": "转派说明", &nbsp;"new<i>users" : [ user_</i>id, …. ]}<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">{
    "code": 200,
    "data": null,
    "msg": "操作成功！"
}</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_todo_user_ticket

# 工单ID
ticket_id = "1750146013372477"
# 当前节点
current_node_id = "Activity_0hnid40"
# 操作用户
user = current_user.id
# 输入参数
data = {
    "description": "转派工单", # 转派说明
    "new_users": ["803d9f10-0a37-11f0-a73f-0ad3783d570d"] # 转派用户列表
}

# 转派工单
res = sdk_todo_user_ticket(ticket_id, current_node_id, data, user)

return res</code></pre>
<p>&nbsp;</p>
<h1>获取流程变量</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  获取流程变量
res = sdk_get_ticket_evn(ticket_id)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>ticket_id： 工单ID。值为&nbsp;string<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">{
    "XXXX": "xxxx"
}</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_get_ticket_evn

# 工单ID
ticket_id = "1750146013372477"

# 获取流程变量
res = sdk_get_ticket_evn(ticket_id)

return res</code></pre>
<p>&nbsp;</p>
<h1>更新流程变量</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  更新流程变量
res = sdk_update_ticket_evn(ticket_id, current_node_id, data, user)</code></pre>
<ul>
  <li>参数说明<br>ticket_id：工单ID。值为&nbsp;string<br>current_node_id：当前节点ID。值为&nbsp;string<br>user：操作用户。值为&nbsp;string<br>data：提交表单数据或输入参数。值为&nbsp;{}<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">{
    "code": 200,
    "data": null,
    "msg": "保存成功！"
}</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_update_ticket_evn

# 工单ID
ticket_id = "1750146013372477"
# 当前节点
current_node_id = "Activity_0hnid40"
# 操作用户
user = current_user.id
# 输入参数
data = {
    "test": "更新流程变量"
}

# 更新流程变量
res = sdk_update_ticket_evn(ticket_id, current_node_id, data, user)

return res</code></pre>
<p>&nbsp;</p>
<h1>获取节点处理人</h1>
<p>&nbsp;</p>
<pre><code class="language-plaintext">#  获取节点处理人
res = sdk_get_ticket_deal_user(current_node_id, ticket_id)</code></pre>
<p>&nbsp;</p>
<ul>
  <li>参数说明<br>ticket_id：工单ID。值为&nbsp;string<br>current_node_id：当前节点ID。值为&nbsp;string<br>&nbsp;</li>
  <li>返回说明<br>res：。值为<br>&nbsp;</li>
</ul>
<pre><code class="language-plaintext">[
    "0624e6d2-8ea6-11ef-a06f-0ad3783d570d"
]</code></pre>
<p>&nbsp;</p>
<h2><strong>简单示例</strong></h2>
<p>&nbsp;</p>
<pre><code class="language-plaintext"># 以接口代码为例

# 导入SDK
global sdk_get_ticket_deal_user

# 工单ID
ticket_id = "1750146013372477"
# 当前节点
current_node_id = "Activity_0hnid40"

# 获取节点处理人
res = sdk_get_ticket_deal_user(current_node_id, ticket_id)

return res</code></pre>
<p>&nbsp;</p>
<p>&nbsp;</p>
